home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / program / jrhrkrm2.lzh / JRH-RKRM-2.readme
Text File  |  1995-09-21  |  3KB  |  58 lines
  1. Short: E versions of RKRM examples (Part Two)
  2. Type: dev/e
  3. Author: jason@fsel.com (Jason R. Hulance)
  4. Uploader: jason@fsel.com (Jason R. Hulance)
  5.  
  6. JRH's RKRM Examples (Part Two)
  7. ==============================
  8.  
  9. (Part One of my RKRM translations are available from the same place
  10. you got this, or as part of the v3.2a distribution of Amiga E.)
  11.  
  12. This archive contains translations of all the examples from the
  13. following chapters of the RKRM (Libraries): Expansion, Graphics (all
  14. the corresponding chapters), IFFParse, Keymap, Math (minus the FFP
  15. examples) and Utility.  Also included are translations of all the
  16. examples from the following chapters of the RKRM (Devices): Clipboard
  17. and Console.
  18.  
  19. The examples retain most of the original comments, with comments
  20. specific to these E versions beginning "-> E-Note:".  A lot of effort
  21. has been put into showing how to effectively use E features such as
  22. exceptions and lists.  A number of bugs in the original examples have
  23. also been eliminated.
  24.  
  25. If you are new to E you should pay special attention to the effect of
  26. using exceptions: error handling and clean-up are neatly separated
  27. from the main code, and the code is generally much less indented.  You
  28. should also notice the special care taken to initialise variables
  29. appropriately so that clean-up is made much more simple in the
  30. handlers.
  31.  
  32. Two standard support modules have been bug-fixed and included with
  33. this archive.  They are 'tools/longreal' and 'tools/inithook' (which
  34. is a replacement for 'tools/installhook').  The 'longreal' module had
  35. the following problem: dFormat() did not print negative floats
  36. properly (especially fractions between -1 and 0).  The 'installhook'
  37. module needlessly used the 'data' element of a hook for its own
  38. purposes.  'inithook' does not do this, and allows you to use an
  39. optional third argument to specify the 'data' for your hook.
  40.  
  41. If you wish to recompile the sources (I expect you might...), you will
  42. need my Typed Modules (V40), my AmigaLib modules and my UsefulV2
  43. modules.  These archives should all be available where you found this
  44. archive (Aminet? In 'dev/e'?.  Most are also part of the v3.2a
  45. distribution of Amiga E.
  46.  
  47. These executables, E sources and E modules are all Copyright (C) 1995,
  48. Jason R. Hulance.
  49. The original RKRM examples are Copyright (C) 1992, Commodore-Amiga Inc.
  50.  
  51. You are free to use the files in this archive to help create your own
  52. programs (whether they are freeware or commercial), but if you wish to
  53. distribute any part of this archive you must include it all,
  54. unmodified, and with this file.
  55.  
  56. (Hopefully, there will be a Part Three which will contain the
  57. remainder of the RKRM examples.)
  58.